<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>getimage</title>
    <link rel="stylesheet" type="text/css" href="../../css/index-table.css"/>
</head>
<body>

<pre>
<font size="4"><a href="../../index.htm">主页</a> / <a href="../index.htm">库函数目录</a> / <a href="index.htm">图像处理</a> / getimage</font>
<font size="4">
<font size="4" color="#0000FF"><strong>功能：</strong></font>

这个函数的四个重载分别用于从窗口 / 文件 / 资源 / IMAGE 对象中获取图像

<font size="4" color="#0000FF"><strong>说明：</strong></font>

如果目标对象包含多帧图像，那么仅获取第一帧图像。

<font size="4" color="#0000FF"><strong>声明：</strong></font>
<pre>
<font color=#008000>// 从窗口获取图像</font>
<font color=#0000FF>int </font><font color=#008080>getimage</font>(
    <font color=#800080>PIMAGE </font>imgDest,       <font color=#008000>// 保存图像的 IMAGE 对象指针</font>
    <font color=#0000FF>int </font>xSrc,             <font color=#008000>// 要获取图像的区域左上角 x 坐标</font>
    <font color=#0000FF>int </font>ySrc,             <font color=#008000>// 要获取图像的区域左上角 y 坐标</font>
    <font color=#0000FF>int </font>widthSrc,         <font color=#008000>// 要获取图像的区域宽度</font>
    <font color=#0000FF>int </font>heightSrc         <font color=#008000>// 要获取图像的区域高度</font>
);

<font color=#008000>// 从另一个 IMAGE 对象中获取图像</font>
<font color=#0000FF>int </font><font color=#008080>getimage</font>(
    <font color=#800080>PIMAGE </font>imgDest,       <font color=#008000>// 保存图像的 IMAGE 对象指针</font>
    <font color=#800080>PCIMAGE </font>imgSrc,       <font color=#008000>// 源图像 IMAGE 对象</font>
    <font color=#0000FF>int </font>xSrc,             <font color=#008000>// 要获取图像的区域左上角 x 坐标</font>
    <font color=#0000FF>int </font>ySrc,             <font color=#008000>// 要获取图像的区域左上角 y 坐标</font>
    <font color=#0000FF>int </font>widthSrc,         <font color=#008000>// 要获取图像的区域宽度</font>
    <font color=#0000FF>int </font>heightSrc         <font color=#008000>// 要获取图像的区域高度</font>
);

<font color=#008000>// 从图片文件获取图像(png/bmp/jpg/gif/emf/wmf/ico)</font>
<font color=#0000FF>int </font><font color=#008080>getimage</font>(
    <font color=#800080>PIMAGE </font>imgDest,       <font color=#008000>// 保存图像的 IMAGE 对象指针</font>
    <font color=#800080>LPCTSTR </font>pImgFile,     <font color=#008000>// 图片文件名</font>
    <font color=#0000FF>int </font>zoomWidth = 0,    <font color=#008000>// 设定图像缩放至的宽度（0 表示默认宽度，不缩放）</font>
    <font color=#0000FF>int </font>zoomHeight = 0    <font color=#008000>// 设定图像缩放至的高度（0 表示默认高度，不缩放）</font>
);

<font color=#008000>// 从资源文件获取图像(png/bmp/jpg/gif/emf/wmf/ico)</font>
<font color=#0000FF>int </font><font color=#008080>getimage</font>(
    <font color=#800080>PIMAGE </font>imgDest,       <font color=#008000>// 保存图像的 IMAGE 对象指针</font>
    <font color=#800080>LPCTSTR </font>pResType,     <font color=#008000>// 资源类型</font>
    <font color=#800080>LPCTSTR </font>pResName,     <font color=#008000>// 资源名称</font>
    <font color=#0000FF>int </font>zoomWidth = 0,    <font color=#008000>// 设定图像缩放至的宽度（0 表示默认宽度，不缩放）</font>
    <font color=#0000FF>int </font>zoomHeight = 0    <font color=#008000>// 设定图像缩放至的高度（0 表示默认高度，不缩放）
</font>);
</pre>
<font size="4" color="#0000FF"><strong>参数：</strong></font>
pimg
（详见各重载函数原型内的注释）

<font size="4" color="#0000FF"><strong>返回值：</strong></font>

<table>
<tr><th>返回值</th><th>含义</th></tr>
<tr><td>grOk (值为 0)</td>      <td>读取成功</td>           </tr>
<tr><td>grAllocError</td>       <td>读取时内存分配失败</td> </tr>
<tr><td>grFileNotFound</td>     <td>文件不存在</td>         </tr>
<tr><td>grNullPointer</td>      <td>指针转换失败</td>       </tr>
<tr><td>grIOerror</td>          <td>读取失败</td>           </tr>
</table>



<font size="4" color="#0000FF"><strong>示例：</strong></font>
请参考 putimage 函数示例。

</font>
</pre>

</body>

